Skip to content

Slim down skill.md into components to improve performance under 40k claude limit#48

Open
itsdevlin wants to merge 3 commits intonoamseg:mainfrom
itsdevlin:refactor/slim-claude-md
Open

Slim down skill.md into components to improve performance under 40k claude limit#48
itsdevlin wants to merge 3 commits intonoamseg:mainfrom
itsdevlin:refactor/slim-claude-md

Conversation

@itsdevlin
Copy link
Copy Markdown

Summary

  • Extracts 7 large sections from SKILL.md into dedicated references/ files, reducing size from 47.5k → 15.3k chars (68% reduction)
  • Resolves the Claude Code "Large CLAUDE.md will impact performance" warning that fires at >40k chars
  • Follows the existing references/ pattern — content is loaded on-demand when commands need it, not on every conversation turn

What was extracted

New file Content ~Savings
references/coaching-state-schema.md Full coaching_state.md template 8k chars
references/mode-detection.md Intent detection + multi-step sequences 5k chars
references/schema-migration.md Per-field migration rules 4k chars
references/state-update-triggers.md Per-command state persistence 4k chars
references/coaching-voice.md Directness levels + failure modes 3k chars
references/evidence-sourcing.md Evidence standard + examples 2.5k chars
references/archival-rules.md Score/intelligence/JD archival thresholds 1.5k chars

What stays in SKILL.md

Priority Hierarchy, Session protocols (brief, with pointers), Non-Negotiable Rules, Command Registry, File Routing, Core Rubric summary, Response Blueprints — everything needed on every turn.

Test plan

  • Verify no performance warning on launch
  • Run kickoff — confirm schema file is read and state is created correctly
  • Run help — confirm command registry still works
  • Run analyze with a transcript — confirm mode detection routes correctly
  • Verify session start with existing coaching_state.md triggers migration check

🤖 Generated with Claude Code

itsdevlin and others added 2 commits April 8, 2026 13:29
… → 15.3k chars)

Resolves the "Large CLAUDE.md will impact performance" warning by extracting
7 situationally-loaded sections into dedicated reference files. The coaching
state schema, migration rules, mode detection, voice standard, and other
blocks are now loaded on-demand — matching the existing references/ pattern.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@itsdevlin itsdevlin closed this Apr 8, 2026
@itsdevlin itsdevlin deleted the refactor/slim-claude-md branch April 8, 2026 22:08
Brings in Lenny's archive integrations across 16 command reference files.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@itsdevlin itsdevlin reopened this Apr 9, 2026
@itsdevlin
Copy link
Copy Markdown
Author

Realized my fork was a few commits behind, updated and reopened.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant